<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<!-- Copyright 1997 The Open Group, All Rights Reserved -->

<title>mvcur</title>
</head><body bgcolor=white>
<center>
<font size=2>
The Single UNIX &reg; Specification, Version 2<br>
Copyright &copy; 1997 The Open Group

</font></center><hr size=2 noshade>
<h4><a name = "tag_001_009_156">&nbsp;</a>NAME</h4><blockquote>
mvcur - output cursor movement commands to the terminal
</blockquote><h4><a name = "tag_001_009_157">&nbsp;</a>SYNOPSIS</h4><blockquote>
<pre><code>

#include &lt;<a href="curses.h.html">curses.h</a>&gt;

int mvcur(int <i>oldrow</i>, int <i>oldcol</i>, int <i>newrow</i>, int <i>newcol</i>);
</code>
</pre>
</blockquote><h4><a name = "tag_001_009_158">&nbsp;</a>DESCRIPTION</h4><blockquote>
The
<i>mvcur()</i>
function outputs one or more commands to the terminal that move the terminal's
cursor to (<i>newrow</i>, <i>newcol</i>), an absolute position on the terminal
screen.  The (<i>oldrow</i>, <i>oldcol</i>) arguments specify the former cursor
position.  Specifying the former position is necessary on terminals that do
not provide coordinate-based movement commands.  On terminals that provide
these commands, Curses
may select a more efficient way to move the cursor based on the former
position.  If (<i>newrow</i>, <i>newcol</i>) is not a valid address for the
terminal in use,
<i>mvcur()</i>
fails.  If (<i>oldrow</i>, <i>oldcol</i>) is the same as (<i>newrow</i>,
<i>newcol</i>), then
<i>mvcur()</i>
succeeds without taking any action.  If
<i>mvcur()</i>
outputs a cursor movement command, it updates its information concerning the
location of the cursor on the terminal.
</blockquote><h4><a name = "tag_001_009_159">&nbsp;</a>RETURN VALUE</h4><blockquote>
Upon successful completion,
<i>mvcur()</i>
returns OK.
Otherwise, it returns ERR.
</blockquote><h4><a name = "tag_001_009_160">&nbsp;</a>ERRORS</h4><blockquote>
No errors are defined.
</blockquote><h4><a name = "tag_001_009_161">&nbsp;</a>APPLICATION USAGE</h4><blockquote>
After use of
<i>mvcur()</i>,
the model Curses
maintains of the state of the terminal might not match the actual state of the
terminal.  The application should touch and refresh the window before resuming
conventional use of Curses.
</blockquote><h4><a name = "tag_001_009_162">&nbsp;</a>SEE ALSO</h4><blockquote>
<i><a href="doupdate.html">doupdate()</a></i>,
<i><a href="is_linetouched.html">is_linetouched()</a></i>,
<i><a href="curses.h.html">&lt;curses.h&gt;</a></i>.
</blockquote><hr size=2 noshade>
<center><font size=2>
UNIX &reg; is a registered Trademark of The Open Group.<br>
Copyright &copy; 1997 The Open Group
<br> [ <a href="../index.html">Main Index</a> | <a href="../xshix.html">XSH</a> | <a href="../xcuix.html">XCU</a> | <a href="../xbdix.html">XBD</a> | <a href="../cursesix.html">XCURSES</a> | <a href="../xnsix.html">XNS</a> ]

</font></center><hr size=2 noshade>
</body></html>
